sides 'No. of cylinders' On decimal) 

Free [devname] U sage : Displays 

Syntax: RUN Gll~ 

BASIC09 to do c 

GFX2([path]<funct: 

handle enhanced 

Usage : Graphics 

windowing comm 

help to users will 

@IDENT Syntax: 

froin OS-9 memoi 

single line output - 

directory @INIZ Svn 

@INKEV Syntax: ta 



interleave value: Cm decimal) (§>FREE Syntax: 
number of Free secto rs on a device @GFX 

ce package for 

Syntax: RUN 

BASIC09 to 

Syntax: none 

idle graphics/ 

Give on-line 

of help topics 

?r information 

^mory -s = use 

at execution 

Ittach a device 

subroutine to 
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the proc 
memory 
text flies 
memory 
directory 
module c 
Merge < 
@MFRE] 
@MODP 
memory 
compare 
to module 
module M = m; 
Usa^e : Set m* 
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erify 

j^lc mn<, TT . nnm^^lc TRHk ^^7fn^T-^VPF S.rnt^ vrMnntypP [opt] 

f monitor m - 

e : Creates 

S Syntax: 

Opts : e = 

Prints the 

lithe current 

rilename> 

nb <i-\!:ode 

ax: Setime 

@SETPR 

process to 

interpreter 




Addresses for Correspondence 

monochrome rH Edito ria l M a t eri ai : 

and links an Ct ^ ^ 

Procs [e] Usag* Gordon Bentzen 

display all pro- ^ ^dm Street 

current data d SUNNY RANK O ld 41 09 

execution direct Subscriptions & Library Req ue<st<^: 

Usage : Gives 1 Jean-Pierre Jacquet 

module> Usag< 27 Hampton Street 

i:vy/mm/dd/hh:r DURACK Old 4077 

Syntax: Setpr % 

num @>SHELL 31 

@TMODE Syntax 

the op€ 

[yalue] 

<modna 

Wcreat^ 

Initialize arf 

from stdin -s=type = set screen type for a window on a new screen @XMODE 
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Here is yei another appeal for 
contributions to our newsletter. Can you help 
to fill these pages with soaethinq 'jshich say be 
of interest to other National USS Usergroiio 
laesbers?? ye woald be happy to include your 
questions here so that soaecne aay be able to 
help with a solution. 

Qup aeabership continues to grow with soirse 
S5 sesbers spread across every State in 
Australia as yeil as Papua Neu- Guinea, Ger»any 
and the United States. The predicted acve to 
OSK has not as yet been widespread sithin 
Australia aith the majority of cur seabers still 
happy to run QS9 on the Tandy CoCo fasily, but 
who knotfs shat the future sill bring. I knos of 
one of our usercroup iseBibers 'Jiho has olaced an 



order for the HHi but 1 won't [uention his nase 
at this point. 

iJSS continues to hold our interest despite 
the fact that it is far fros the iaainstsaia 
operating systes. ye all have had, no doubt. 
soRse exposure to H3-D0S, and sosse sou id say fa? 
too such exposure for their liking, but se still 
cose back to 0S5 because ae aiss the aany 
features of this poserfui operating systes ishich 
are non-existent in other systeSiS. OSS and OSK 

r-Ti hi "t!jn" sc ^lall ic t pijct pL t i rin it tisiqc 
n j? t i rn { ;.T\ '( 1/ lahdn ihinnc ":-!r. t.Fr-nnn" " nn Mpripp" 

However, help is always available fros other 
QSS' srs . 



our fsescers tpcrii 



LanDeri"; 



1 W 1. '- t t V k 1 U %1 U ■_ ■■! .1 I I u I .. '.J 1 A t w v-w : J ^ .^ v w W W 

!jtilic-iT>n tho PnTti t fiitTl-c inTanfara Hr,>.:i LiKfin 

one undertakes a project like this^ one can 
expect to run into a fes probleas along the say^ 
aainly because se are suddenly faced yith 
unfasiliar software and procedures, aell our 
aan in Canberra did run into a couple of 
probleiss which prevented his froa being aole to 
foraat the newly added hard drive, and he had 
reached the point of coispiste frustration when 



he decided to contact ae. Don Berrie -ihs also 
dragged into this problea (not that Don needs 
auch dragging whenever an 0S9 problea appears) 
and ye were able to helo out. The hard drive is 
now formatted under 0S9, and we were advised by 
our Canberra aesber that he had tracked down the 
source of his proDle^. So here is a tip; when 
building a device descriptor for a hard drive, 
QQ NOT set the "park track" as track zero, even 
if the hard drive in question does not need to 
be 'parked' or has 'auto-park'. 

This is just one exaaple of how we can help 

asrh nthpr inrt thic avnar-y cnra te,^\i plcn hair. 

soaeone else, we hope so. 

So what is your particular problea with iJS9? 
Of perhaps you can pass on a few valuable tips 
froa vour own experiences. 
PRQBLEH: I have used the screendusp utility 
"Sprint" in asseabler froa the P.O. library 
^hich is fros Ron Laasardo. This utility duaps 
a text screen froa a specified window to "std 
cut" by default, or allows redirection to the 
printer. Now when I redirect outout to sv 



' underscore character 55F is 
" $5E is printed as "*' in 



printer the 
ionored and the 

Tp-i.'fl?c3 Ma! n i i 

IN THIS EDITION:- 

Bob Oevries has included C source for the HAN 

utility a la UNIX HAN which allows .doc or 

sanual files to be listed. This is a very 

ncitn! iifilitv friT* HirH ripi'/a iicarc sriH rr.iiirt 

ilcA Ki hanH'.-' tnr i i^cnr-.M KiciiH cwctara -it ill 

-UA^'w w-.« iEuji'^1 ; -J I Q lAVVKT w-Swww wfwv^^u At ^JAA 

"^iniisl" fi^ac hipna rinrari .-■n ,-ina Hici' 

Don Berrie has included soae sore info files 
froa the CcCo list server which helps us to keep 
up to date with developments overseas, 
we continue to work on the long promised 
database of the public doaain library, so don't 
give up hope. 

Cheers. Gordon. 



CoCo-Link 

CoCo-Link is an excellent aagazine to help you with the RSDOS side of the Colour Coaputer. It is a bi- 
Bcnthly sagazine published by Hr. Robbie Daizell. Send your subscriptions to: 

CoCo-Link 

31 Nedlands Crescent 

Pt, Noarlunga Sth. 

South Australia 

Phone; (98) 3861647 
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Setting SAS-sy iJith Your Disks 
by Psti Lyali 



yhethsr folks are finding hard disks to be snore 
affordsbitf. or aandatory for increased storage 
capabilities, soae coabination of the above is 
causing aore of thea to appear on Coco3 (and 
other) uS9 systess. tfith ail this space, power, 
and capability coaes the the inevitable list of 
questions and confusing options. ! won't 
atteapt to deal with thes all here, but I sill 
try to clear the air on a couple of device and 
path descriptor options that seea to be giving 
soae nes hard disk owners a bit of a tough tiae 
- OD.SIT (nuaber of sectors per cluster) and 
IT.SfiS (ainiaua sector allocation size). 

Since the 0D.3IT is a bit easier to cover, let's 
do that first to get waraed up for the other 
stuff. Another good naae for OD.BIT aight weil 
be 'ciustersize' . In order to understand what 
clustersize is, we're going to have to dig a 
little bit into the layout of the disk. All 
disks J be they floppy or hard disks, have at 
least three things on thea when they are 
initially forsatted. These are: 

- Logical Sector Muaber Zero (I'M) 

- Disk Bitaap 

- Root Directory 

The LSNy is essentially a sector containing all 
the inforisation about the disk's personality. 
It contains inforsiation on hote sany tracks and 
sectors the disk has., and also how aany sides 
'or heads in the case of a hard disk) ar^ 
available. Other inforaation includes the tinie 

♦Kit t'hic '..'ninrrVQ fH^cVl wac rnostoH r.T 

forrsatted, sho the owner is., where and how large 
the boot file is (if any), the disk naae, ana 
lastly the bitaap inforaation. This bitaap 
inforaation tells the systea how aany bytes are 
in the bitaap, and what the size is in sectors 
(clustersize) of the space that each bit in the 
sap represents. Hore on this in a ainute. 

The bitaap is basically a aap of the space 
available on a disk. Each bit of each byte in 
the bitaap represents a block of space on the 
disk. One analogy to the bitaap would be the 
seating chart you aight see in a restaurant when 
you are in the reception area. Tables that are 
aarked on the chart with an 'V , or possibly 
illuainated by an LED, indicate that the table 
is in use. 



Tables that are not exolicitly aarked are 
available to be used. r!uch is the case with the 
bitaap. If a bit is on (in the M' state), it 
tells the systea that the block of disk space 
that it represents is in use. what the space is 
used for is of no consequence to the bitaap. It 
could be part of a file, a directory, or even 
part of the bitaap itself. Conversely, an off 
bit ('^') indicates that the space is available 
for whatever needs it. 

Notice that I have sanaged to avoid defining how 
big this space is. The reason? It is variable. 
Each bit in the bitaap represents one cluster. 
The size of this cluster is defined in DO. SIT in 
LSN0, which is read by the systea before any 
other aanipulaticn of the disk is done. A 
cluster aay be froa 1 to $FFFF (65535) sectors 
in length. 

Ready for a surprise? Alaost everyone uses a 
cluster size of 1. So why bother with all this 
confusing talk of clusters and sectors? There 
was a tiae in QS9 history when lower density 
floppies were the predoainant storage device. 
Ta going to hazard a guess and say that early 
055 prograasers decided to liait the length of 
the bitaap to 1 sector, thinking they wouldn't 
need any acre. After all, if we consider the 
case of clustersize = 1 sector, and a forauia 



(TRACKSI5EeT0RS/BITSpsrByTE)/CLUSTER£IZE = 

PTTH6P QT7i: 

a single-sided 35 trac^, aouble density drive at 
lb sectors Di? track (sianoard osS foraat) only 
requirea 7a Dyies of bitaao space (35llfa/S)/i, 
and a single-sic-ed 77 track 8 inch disk, at 2b 
sectors per track yould fit into 251 bytes of 
bitaap space (77t2S/8)/l. 

The probieas case with drives of higher 
capacity. A conventional double sided Stf track 
drive would overflow the bitjsap sector 
((3etlbt2/3)/] =320 bytes). You can easily 
isagine how a hard dis^ aight affect this 
situation. Enter clustersize. If the 
clustersize is set to 2, each bit in the bitaap 
now represents 2 sectors of disk space. In the 
case of the 3^ track floppy above, this alters 
the forauia to ((3dJi6J2/o)/2 = 169 bytes). At 
a clustersize of 2 sectors, the bitaap can 
represent roughly I aegabyte of space. 
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hiV6 * ''• Hs rsi^sd ^-C ^^ SwC"Ors to rs^^rss^n^- s S 

r^fi-t^h\r' ij :-iri-.ja in :: nnp zijrirtT* hitman Cr.? j ""^ 

ssgsbyie drive, sscn bit in ihe bitisao yould 
have to rsDre=ent 40 sectors, and it ge-s 

whsrs i!s can start to 569 the flaw in this 
design. Suopcse votj need to create a verv ^hort 
orocedLtT^ file that .ere to contain the c^'^Smand! 



!criO 



~Kic fiip chnnlH r^GU''^^ ■'Miiv ih-ttif 7^. h-ftac 

inrliitiinn the rsrrisnp roti'rn Car si sea tpjC 

KarriwLi'a firovyant: mc tfONi iicinn invthinn wrsjilaT* 

than z cartnf niip fi^o ^i'^P will ("'P V^ h--tuC 

but the disk space used should be I sector. 
Assusing that we had done this on the 29 
segabyts drive described above, we would 
actual iy have used 4d sectors of disk space (Id 
kbytes) - a waste of 35 sectors. 

yhy? Because the ainisus chunk that we could 
sark as used or available in the bitsap sas iy 
sectors, yhen ye aarked the area as in-use, se 
also sarked the rest of the cluster as in use. 
yhat a 'pastel 

Fortunately, Hicroyare felt the saise way and 
altered the bitaap design. Noy the biteap aay 
be laore than one sector in length. In fact, it 
sav be up to b55o5 bytes lone (8192 sectors). 
The nuuiber of bytes in the bitmap is also 

cncr ■! + ^ fiti-i in ! QWH i r, nff l>iQp Tf - i iicT arc: to 

yere I sector, this bitmap should be large enough 
to service a 130 aegabyte hard disk. 

For larger disks, the clustersize has to be 
raised to accoasodate the caoacity. A 
clustersize of S, for instance, could handle 
sore than ! gigabyte of storage. The current 
bitaap size and clustersize ceiling is capable 
of supporting a disk that contains 1.873,741,324 
sectors, or approxisiately 255 gigabytes. I 
think it should last us for a while, eh? 

That's probably ail you'll ever santed to knotf 
(or sore) about clustersize. For almost ail 
practical purooses, it should be left at a size 
of I sector per cluster. This is sufficient to 
support those of us with disks that are IS'J 
segabytes or ssalier. 

The 'IT.SfiS', or segsent allocation size, is 
used to detersine hos such of the disk's real 
estate is given up each tiae a request for sore 



ais;^ soace is ?isaue. -is :te^ i= iccated in the 

processes) a sector at a tiise, as they need it' 
In a word - fraosentation. That is, your file 
could end UD beinc severely scattered over tne 
disk's surface. This aeans that it taices aore 
tiss to read it as several seeks to different 
locations on the disk say nave to be '^ade. 
Also, you could potentiaiiy run cut of segsent 
sao soace Srief-v -^ach file and dire-" tor v nas 
a sector set aside for it that describes its 
cnaracteristics . This is known as the 'file 
descriotor sector', or FD sector for short. 

In the FO sector are data concerning the oyner 
01 ihi file, the dates of creation and last 

wri.^fi t i rat jnn tha napst cc i Anc tilaciTa anri 
lictiv; a man rrrntaininn a -icT r:i what qar-i-nrc 

the file occupies on the disk. This aap has 43 
locations available. Each sap location reserves 
three bytes for the logical sector nuaber of the 
seoicent (LSN), and two bytes for the nusber of 
sectors in that segment. if the disk yere 
reasonably full and highly fragmented ^ it is 
conceivable that you could fill up a segsent 
list sith 43 entries of one sector each - a I2K 
file sould cause an error 217 (Segment List 
Full). !n order to avoid this, the RBF lanager 
tries to reserve a certain afsount of sectors for 

til a avnar^inn aarh t i ap =■ fi]a noartc Sfrro ^i-intri 
Ih.a nn»Kiap nt ccrr-pc ffl Ha arlrJoH + ,-, tho filp ic 

1 I t ■- I t U 11! U 'W 1 -^1 _- W ', v.- 1 -> - V WW u u u w u u W V t I W : * A C k w 

cnar ■! t i a,-i in IT vuv f.-iP iftnct i}r,nr,\/ Aicvz, 

this nusoer is 3. A good rule of thusb is ;o 
use sose even fiiuitiGle (or division) of the 

nii-isKap ftt cprti-iT«c auailarilp nn a trart/ 

iijuib^^. 1 KJ 1 wC'. t/v I J ^ 1 u .1 A Qw 1 C '.ill '.• tf I -^k 1% . 

^no i'la guessinq that's ^hv a default 3AS for 

+ ! :-i nn i ac i q '?, z a r i .- - -a : r,r, a K a I f ,- t a f t a r i: \ T 

be^- if the^' ' d thouoh* ''-i it thev souid have 

aade the SAS value for Color Cosputer forfsatted 

disks 9j as that disk foraat has \'6 sectors per 
track. Since isost hard disks have 32 sectors 

per track (25b byte sectors), IS and 32 are 

cosson values for IT.SAS in hard disk 
des-- r i'^tors 

Allocating extra space to a file does not change 
the file's size, if the file is only occupying 
35 bytes of the 3 sectors, its filesiie will 
still shotf as 35 bytes. The rest of the 3 
sectors is only standing by for use as expansion 
space for the file, but is not yet in use. It 
is however unavailaoie for use by any other 
file, and is ;aarked as being busy in the disk's 
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Py no™ V OL' ' f'-' Dr-'-bdDiv tninKin'^ thst this -5 5 

hni»rTKl-ij iiiLCtuf'tl ^nntiMrh Mprc ' c t ha -j-fr-, ' 

* n Tha '""fia cnsra ru-n-i] ■■ f t)-ra t i 1 -l rifiiniaTi tu^z 
at ♦hp uTiri -it tha t'iIg That ic i t" kio hji-i 

yritten the 35 byts file above, olt 'srite 
Dointer would have soved forward one byte sith 
each character we !*rote to the file, isihen we 
srote the 3Sth character, and then closed the 
tHa yg '^'efg at thfi snd of file. As a result, 
the bulk of the reserved expansion space (in the 
case of a floppy. 7 sectors) was given back to 
the systes. 

This is tfcnderfui for files that will be ^^ritten 
or updated infrequently like ASCII text files 
written i'ith your editor. If you think about 
it, you are not changing existing files, but 
writing out a nes file and deleting the old one 
each tiae you edit. This is not so wonderful 
for files that are continually altered or 
expanded, like database files. These are the 
files that really need protection fro:? 
fragsentation. 

Fragfaented database files (or directories) can 
sake for extresely slow search or lookup 
operations. What can be done to effect this 
protection and hang onto the reserved expansion 
space: Sisple - iust scve the file pointer to 
any place other than the end of file. This is 

nni'Milli; liAna with i cooi' :-i-im»sn1 siric^ - -iftRirtn] i.' 

M-.1I 1110 4 4 1 u-^jitw nl '.-II 3 ^wwr. . •.■lil>tiu [ I'j : .li-w— -.r b w i;>IItL' 1 1 4 t 

t n Irtfstirin H in fha fila {iic.* L--n:-Mr! sc 
'" pohii nrtiTii-j ' z f i ] a t iJhan tha f i f a ic rir.caH 

I W II 4 I I U 4 1 t ■-{ U I 4 i W ; . V I I ■. t 1 V 1 I C '. 4 1 W 4 ^ '. 4 '.■ .' W^ . 

Hhatavoi* cr.ira hL.-i hopn jJMrqtari to i * ^ = 

■ liavwTwi ^]^U1.1- lIljU WwCll ^J i 4 VW a VW'iJ WW 4V u.^ 

avranciriH v^ftr-.m ic bant triP fijtiipa ijca inri nnT 

returned to the free space pool. 

This technioue is used by the systeni in the 
creation of dir^^ctories Each tise 'HAKOIR' is 
run. it allocates the number of sectors 
specified in IT.SAS for that disk to the 

fiirartnrw \inii rrpata fuan thfiurir, tha til am" to 

say be hi (rcog for the '.'and '..' entries),, 
the allocated space will be several sectors. 
This will prevent your directories froa being 
scattered in several tiny chunks over the 
surface of your disks. 

Could you iaagine what the iapact of having a 29 
sector ChOS directory that was fragsented into I 
sector pieces? If you typed 'dire' instead of 



'Oir 5' 'iOiii neaos ■i'-uic navj^ vC Eeek at, least 
20 iig^es ^ust to firsd oui- that there is no 
'dire coisEand and rs^ue an error 2!b 

There is a ssjail disadvantage to this philosophy 
as yell. If you are creating directories that 
you know in advance yill only have a fey files 
in thes^ that extra oirectory space sfill be 
peraanently wasted. For this reason, I wrote a 
variation on the 'HAKOIR" coasand called "skdir' 
(Unix and HS-DuS users have one - shy not us?). 

?1kdir allocs you to specify either the nuaber of 
directory entries you wish to aake roos for, or 
iust hcs sany sectors you sish to reserve. Also 
available is the source for a utility called 
'faap' (file napper). This utilty was ?jritten 
priiaarily to alios inspection of the FD sectors, 
but is also useful in looking at a file's 
allocated space vice actual filesize, and its 
degree of fragaentation. 

The sources to both of these prcgraes are froia 
early C prograasing efforts. and are 
consequently soseahat inelegant. If I let that 
stop ae, I'd never publish or post anything, so 
here they are! For those without access to a C 
coapiler, the binaries are available for 
downloading froa the 0S9 For us on CompuServe in 
the UTILITIES area (DL3). [Source and binary 
files are available frcs the our PO Library .. 

art] 

I hooe that I have sanacied to shed a little 
light on sosie of the less obvious areas of disk 
aanaqesent, and oossiblv even desystified the 
dis^i bitsao and the nature of IT.SAS to soae 
degree. I as always dvailabls in the GS9 Forus 
on CoBpuServe for questions and coasents (as 
either 'Sysop' or 'Pete Lyalr - User Id; 
787^3.4230), and I check into the Delohi OSS 
For us at least aeekly under the usernasie 
'QSSiiSyp'. 

For those yith access to USENET, I can be 
reached at {scgvax,ihnpi.ipIqodG}iwlbr!pete or 
on the Internet at pete'*wlbr.eaton.co9. 

Please feel ive^ to contact se with any 

questions you say have. Until the next tise, 

happy hacking^ and resssber to backup your disks 
before getting too creative! 
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or Access thoss docs ^i^ilv' 

I hdVS il-JSVS ff^It "'"■hit thOS8 of «S -i'ho T"^^ ' S-^'-i^ ^ ' t i *5 i i- ^^'d ''-Ut this -i-'SVi 

Ditroni'^s th^ "ublic Dosisin Librs^'v sus^- hdV?^ 

those docuisent flies are. Those ^/ith hard disK PATH /QD/SYS/ 

drives, of course, can put thes all togetner in yiEs;5Jore 

one directory. But then to access theis quite oTART_HAN 

often lyteans to nave to type a rather long ar /DO/JIAN/ar.aan 

""i"ira?r'i (ii^i -zc^.ar ^ z.] ', --.t if tSc i-ji T^Dr + .-.T'u i - iP-hiYp /OH /Biiri/ ir-rKi vfi wan 

50B9 way down the tree. Soaethinji like 'list ed ied /D'J/HAN/eddccs.txt 

/DD/uSR/uuCS/ar.san' . And then you have to t^ HAN 
resesber shat is in the docs directory. A bit of 

a pain really. There fflust be 2y characters and/or spaces 

betifeen tne first character of the prograsise 
Recently. I carse ac cross a prograsse which nase and the path to the docuaent file 
solved the probleia for se. It yas an Aaioa port inciusiva. 5o in the first sxauple! 
of the UNIX prograsae 'HAN*. The prograase, 

cofsplete tfith docusent files and source code ar /DQ/HAN/ar.iaan 

case fpofi the 'Fred Fish' collection (a '--29 characters—' 

rn] lc.ri i. ,-T\ T; t zns,a AKH riicUc :-.t PP. inr tha Caini 

at O.'AVik' r,ar :-| i c I- 'i T triAiinKt i+ i.i.-Mi";-i Kq a nnr-fi Yr.n ui li nntirc thst + ha t.hirH nT»r.ni'3nao hac 

S V -w w V 1'. >/w t .J k .^ n. .; . 1 -J I twidwi t J k V B vu ^ w u w u '^u-- '-I I 'w ti •• k A A IIS/ V ^ w w v> >u v VI Iw tri 1 & I -J w I •jKj I QnSw s iSZ 

exercise to re-srite the source code, which sa=. an exclamation sark in its path list. This is 

of course in C. for (jS'3. welL it turned out to done so that a coapleteiv different prcgraasie 

be reiativeiy easy, as the code is not overly (ed in this case) sill be used for that docuaent 

long. only. Hake sure, hoisever, that the prograaae 

fsentioned in that line is in the current 

The prograsse is Quite versatile. You aay execution directory, or in aeacrVj or it sill 

specify the directory path for the documents, not run, and sill net return any error (i sight 

and also the prografsae sfith shich to list thes. fix that later), 
on the cOiSaand line. The proQraisiise's defaults 

are! 'list' ^or disolayino the ules, and Noy to the source code. You yill notice that 

'/DD/JIA^' for the directory in loo^ f^r tn^ I have left the code in such a yav that it 

document files. No special equipaent is required should re-coapile on the aaiga still, as sell as 

to compile the procrasae (except for the C on the QS5 systeis. To coaoile, you snould use 

rrr-niipr :j*' C:?ur^e) th* coissand line Switch "dosS' .hich has the 

csftc at tart jc i l^He ipi the soufce whicn savs 

Cosnsand li^-^ -"-Dtions are as ^'oilCwSi '^define o^9' S'* the c-scil'^r 'OmSsand lin^^ 

looks like tnisi 

~v specify a nes file viewer. 

-f display the first annual page only. cc aan.c -do5'3 

-p add a path to the path list. 

-d display path lists. without further ado. here's the source 

listing, yhich is of course also available froa 

The prograaae can get extra path inforsation our P9 library, 
froa the file called 'aanuals' which is keot in 

the saae directory as the docuaent -'iles. You Reoards, 

say also specify a viewer prograaae there to Bob Devries 
override the prograaae 's defaults. 

i Man V].2o i 

t Copyright (C) 193*3 by G. Glendown i 

i t 

t This prograa and ail docuaentation is placed in the public doaain. t 
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iNo fs" r;':8v b& !"h&r!'!^d sxcsot for u'EOia ind ci'^ovinG ArcPrs'^ nfesv b& -T 
i irirlud>^d on F?&ii Fish's dibtribuiior; disk Anv ^ihsr PO~c'!li&^i-'^ % 
t yill have to G&t ikv ptrn^ission prior to Duttinq han on his disks, i 
x ht^v T'^i- ^srvics fitcV distribute Hari as loni"" as n- f&9 tor X 

tH - jjn ! Q j|i^ n,-> i c rhjrnpH (iyprn-f finfSal Iin& C!"-^*-S^ VnU (giV I^akS Snvt 

t chanoBs to Han but I i^^nuld aoort'ciate it. if vou could S8nd m9 tHp !?! 

1 r:£:y ^r:;jr^pc ( c V f £j T; t ronvt^^ions t.n LnttiC8~^- 0"^ il^^duls"!!' '''■? at t 

^ it-ast a shf^rt nots abou'- what vou did '^■ 

T j. 

t ?jppry:i.n PH dSdl^rSl t 

j PI pjco f9^ij i-h^ iiiB ' G^rsanL- i s tr ^ but 1 Of: ' % 

% ;!■ X i i j i .;; i t t ; j; t : J t %%%% % t % X t X 1 1 tttt t i- X % % % % 1 1 % t %XX.iJ.% X % % % '.f .| t ^' 1^ ■"'^ 1 1 -t ^ ?• X ^ X. X. t X X I 



n is=i '/ 

^- Han vi .2 

i 

t Unix~^t.vi?^ fifianuai c-fi^ifiand cnnt-rnjlpd c^'-EiOlsttlv ^v 

% t, h 5 f i I H " !i: ? f; '. [•; a ri u a 1 5 " 

X USAGE; 

■t 

X ?\dr\ ^'iianuai) [-vTextViE'i:/&r] L-pPathJ C-fl 

X 

tdsfina LINE 5i2 

ii;jc.tir-;p NjqYpn^j If. ix Haxi^^fius siz-*^' ^'t cnrosano naniP' ?/ 

itt-ic-f ■• -c Py"'!!'-: Vt-l .'i ct^rr n-tc ■! t i i-n r.f --iVimznA 1 i np.'' f i 1 pnnrfip T/ 

?ifdtt asioa 

j^rjpf jT-:£i l^ANFlL^ "' iuan ! ifianua 1 s " 

iHpjinp PiTJ exitiOL^' 

lendK 

t' tdi^* OS*^ 

?^dsfine HANPilh "/DO/HAN/fitanuals" 

Sdff li^8 E)( IT exi t (^) : 

?t9ndi f 

/x i.'n* ofsFfitint this if vou d-'^n't havs ffiv library ii^ith a n&y Prin^F J-' 
cHpfinp FfintF '^riritf 



FILE IfhJropeTiO: 

C Hd r -t- 1 G9 ts ' ■ ' 

char i ineLLlNEJ .y[HA)(COH(( 1 J 

tifd^f asiga 

char cffisr!dL!28j=("run less "' 

tendif 

ttitdef Gs5 

char cfiand[]2S]='''ii5t '; 

5 6 n d i f 
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fd&fint FIRSTONlY (]((]) 

mi pt; 
char inafse: 



Ejipt^np fj^rv-So KlAD ^ 



/ 1 X 1 1 1 1 ± 1 1 1 X 1 1 1 % % t % 1 1 % t -^ t ^; ^^ I j -t j 1 1 J i % % -t- 1 ^' 1 1 % 1 1 + 1 1 ? J i t -f t % % t % ?■ ? -*■ i 1 1 -t i t ? ? ?^ -r '' 

T s s i rs ^ 

i t 

i jjnp^. al^ SLannino ^''i ^-hs CLI '"!dr5rM&tHr5 Drinks ib^ Daths dst'^nt-'d t 
I and checks the 'manual 5 '-tile. i 

\ i T Y T T T T i; T i T T i t T ;? ^f .■»; T T t i; i | i i t i + rirr i 1 1 .^: t i i: i j j j t i; 1 1 1 i j j t; i x 1 1 -I i -t t -t I ■?■ t J J ^ -t 1 1 

^ain(drqc ,arqv) 
int arqc! 
char iarqvi] ; 

Char ic: 

1 nt t • 

Sifdef os9 

Isjldi f 

It iiTgii-]) 

Pnnt-FCUse 'Zs Rsan' to see usage ot I5\r:",arqvi9],argviyj) ,EXIT 

cnt=0: 

iP ft'l't^aroc 

it (arqv[t]iyj=='-' ) i 

syitcT; (toupp&r(argyLi]Ln)) ( 
case 'V : 

s i r c '^- V ■ I f c ssifid L 4- 1 ) u ' a r ^'V L i 1 1 2 i ) ) ' 
sircaticfiiffiiid,' \r): 

break: 

strcpy(pdth[pl],sargvLtJL2j): 

pt++: 

break; 
case 'F': 

Status =FiRSTONLY: 

break; 
case '9' : 

Status =OiSPLAYPATHS; 

break; 
default ; 

PrintF( "11 legal option '%l' ignored\n",argv[t]Ln); 

break: 
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ri-rnij = --r.T:/i t 1 



it ( In5f3t'==tc?"iar* y. -'NULL 'idl ' I'DtslUS^L-lbh'LPYKRIH'!.' 



. f (SiitusiiDISPLAyPATHSJ ( 

p!" iniF' "^dn-paths I \n" ! '■ 

PriniFC X5\n',p3th[t]); 
Pr i ntP!^ "Pi ie~vi&y&r I 'I5'\n" cfuisnd)' 

t r 1 f i 5 p ( t h ) : 

EXl! 

itrnipy^tf^naise^HAxCOH); 
ftrcatfy EHPyy J : 

T t ;' ! f r = t npt c M 1 nc j T hiP t h "i \ I 

Pp T r. t PC'Tirrnc i f|3f|iJ5 1 " 1 1 1" C Of fUD tj vH " ) 9'>:ir;35ii 
i f (' c t. J^fj-i^ K!": ( ] j p^p y c t r- i on t .y 1 ) ==0 ) { 

DisDldVPi 1h ^ J;1 ir!9[FNPG''=] ) ' 
if (Stdt-LisiPIRSTiiMLY ) { 
fcioselfh); 

EXIT 



if (sif'nci^oi 1 ins , "bND r!AN",7)==0) exdiaiss! 



u V { t 



?: ex i 
T Tnis routine looks thrcuqh all defiried patris to find a file thai t 

t iiii 1 1 ifiit rK t ^!0 filor,jrr,o riiuDn if 

1- n 1 1. X il: u u k 1 I V I 1 '_ I 1. 1. i_ 1 1 u lit t_ U 1. t i_ 1 1 . 1- 

t Paraffieters: J 

% - naise of the sanual file (char i) t 
\%X%t%%%%%%%%%%%%%%%%%%%%i%%%t%% 

ex(t) 
char tt; 



It uni==y,' { 
tifdef affiica 



5trcpy(line,"san;'); 



April 1991 Page 9 



AUSTRALIAN OSS NEWSLETTER 



Sifdtf G£^ 



lETidl t 



i f ! F "' u ri d f " / D / H A N / " i ■ ■ 1 

strc"'v(iin& "/DO/HAN/ 



fji qrJ^Ypi 1 fH ins } ' 

■it r^t I, t i ic if T SsTHwi v 



c t r r r- 1 f I 1 n c T_ 1 = 
• 1 i c n 1 -■ M l~ ! \ i ; 1 1 n 






^ i ( \ i r \ Printer " fii r-. '{-.z.~iii:.\ c :• --.i ^ i 1 l h j g ! N r: " "; 

TheEnd; 

if (fh) fcloseCfh); 



I % % t % % X % % % t- -T- % % t % 1 1 1 % 1 1 % % % % T. % t % t ^- % X X X- X i -t. i X- 1 1 ^- 1 Xtii % t. X x. t X- % t. X t i X- X X X i i X t X X ^' ' 
i; Found X. 

T Thic rrriitiD" rhoft'c it ihp t i 1 il i c ^r r qc c j- 1 c i rs rho H i - i,- t -; r-v- t 

■1- I I I ^ ^ t -^^ 'J V ^ 1 1 W k 1 t ^ L l\ -J J 1 1 V I L C I ^ ^ 1^ ^ -J L^ L u u -J ^ ^ W ^ ^ i. 1 t V 1 I 1^ ^^ i 1 ^_ ■_ V -.' < 1 -A^ 

X given as i paraseter t 

XXMXiiittWtiitXMittttittttit^^^ 



T r5ra!7;9t-Sr5 ' I 

t - path yhich is to be searched (char %) X 

t - tiienaise to look for (char X) X 

X^itX%tX■X■XtttXtiX^ttt%%tX■tiXX%XXXX^■'^^^^^ 

X Resuit: i 

t >]< if tile is found i 

J )^3'^ file fioi found i- 

■int ri-ii"'""'! r. n "! 
rj-or i.n jr,' 



Char tiiibbj; 

tifdet asiga 

struct FiieLock ii^JLockO; 

#endi f 

^ifdef os'H 

int i; 
itendif 

strcpyif ,p); 

strcdtif.n); 
iifdsf asiga 

l=Lock(f,.ACCESS_RtftD); 

if (i) UnLock(l), fc++; 

if (1) returnCl); 

else return(^); 
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[ = L r r DC C ( f fJCCESS READ J 

if (1 -- -\) r£tLirn(0) ; 

D I c p - c f I i r- n ;' 1 ) ■■ 

tendif 



% DiEDlavFilt " 

% % %%%%% i i X % % % ^^. % % % % % % t % % % % 'i.t%% ■?■ % 'f ttt t %%%%%% i. % t % % % % % t % ?- ^- % % t % % % % %%t% t %%%% 
% Piri?;;Ht.Hr^ '. 1- 

% " Mn8 iriLiud-^B p'i^ht'r ths fii8Ti3^"i8 or th8 line [■''■ b^ 9'^'6cui9d + 
\ t X % % 1 1 % j: % i i % % i % % 1 1 1 1 1 % i % % ?■ t- -t- i % % 1 1 1 % % % % t % 1 1 i % 1 1 % 1 1 % % % % 1 1 % 1 1 1 % 1 1 ■+. % % % % t % t / 

Hi cr.'i juP-i i if f "t 

chdf ■?-! ' 

i ri ^- i ' 

chip exec[25bj ; 
t=0 : 

it (if==' i ') 

t^^scLits ! Ml n OL yL ^ ' 
else { 

A ,-, . ' 

t-f T ' 

} i^hiis ((t[tJ! = ' ' )ii( f [ t] i = ' \n' ) ) : 
strcpy(exec^csaind) ; 
birncatiexec^ f^i): 
Prir!tF("^s - "J): 

E^'SCU t5 ■ P'X6l -^L 0L^' 



^This r':'Jtin-^ bc^ps ihs "iiidnL'ii5'~til>= for th-" PATH dnd Vlty Li'-Rimirid-J 
T and tries to find tne 'START HAN'-cossind. t 
% i t % X 1 1 T Y i: % t % % % % i % i; % % % % % X % % -t- 1 1 1 % 1 1 % % % t % 1 1 % 1 1 1 1 % ittitx 1 1 1 1 1 1 % '^. 1 1 % % % t i % % 

t - f 1 I unr. 1 n-j w-r t r, + Ka ' (n:jr,ni 1 q * - t ■■ I g "i" 

^t* I X X W }-■ V ^ I I V ^* ( V W V L I V. t}^ u L 1 'J Q X J '.XXI—. r 

S 9 i r c h S t d r t f' f h ) 
struct FilsHdiidle ^fh' 

rhjr lincrij'v>-t Yr- 

for (;;> 1 

if (c=fget3(iine^LiNE,fh)) ( 

It (£trncigp(lin&/START_riAN\S)==y) return; 
if (5trncsp(line/VIEy:%5)==9) ( 

if ( (Stitu£J:CUSTuHv!EiJ)==6) { 
strcpy(cEisnd,&!inelS]); 
CBisndL5trien(cgsnd)-! J=' ': 
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if !"^irncsD n 1119 "PATH " b'^--~'^) i 

i i ir-.i / ! A 1 -f 



btr 'Dv(Ddtr;LDl J SllTltL^J^' 
Ddth[rrtH5trl8ri(Ddth[DtJ )~1 J-* \0' ' 



Krint-r 1. " ! 00 ^ciiv D5t!^5 iH ' iiiin ! fiidnUiib " ~ liit^n' 



/i {lon-exibtani m osS H 
char +exec; 
long du^iriiv! ; 
loDQ dijiiiii{y2: 
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